home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat60 / viewerii / viewerii.doc < prev    next >
Text File  |  1994-02-27  |  13KB  |  335 lines
  1.      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  2.  
  3.                              Viewer v2.0
  4.  
  5.                            --  ViewerII --
  6.  
  7.      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  8.  
  9.       Domaine public. Librement distribuable sur la terre et
  10.       le système solaire SOL. Autres galaxies et mondes
  11.       parallèles, contacter l'auteur.
  12.  
  13.       (pas de copyright) Rodrigo REYES 1994
  14.  
  15.      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  16.  
  17.  
  18.  
  19.  
  20.      
  21.  
  22.  
  23. I. Qu'est ce que ViewerII ?
  24. -------------------------
  25.  
  26.   ViewerII est un visualisateur d'image utilisant la bibliothèque
  27. DataTypes.library, et qui permet ainsi d'admirer des images IFF-ILBM, GIF,
  28. JPEG, PCX, BMP, etc. pour peu que le fichier datatypes correspondant se
  29. trouve dans Classe/Datatypes/ et dans DEVS:Datatypes/...
  30.  
  31.  Quel interêt me direz-vous, puisque des programmes de ce genre, il y
  32. en a plein le domaine public ? Ce à quoi je vous répondrais assurément que
  33. l'interêt est pourtant bel et bien là, étant donné que je le cherche encore.
  34.  
  35.   Ceci posé, ViewerII possède néanmoins deux atouts principaux.
  36.   Le premier est qu'il est en domaine public et qu'il est livré avec ses
  37. sources complets en langage C. Ce qui n'est pas à négliger.
  38.   Le deuxième est qu'il permet d'afficher n'importe quelle image dans 
  39. n'importe quelle résolution Amiga (AGA comprises !), c'est à dire
  40. de pas grand chose de large sur pas grand chose de haut, jusqu'aux
  41. résolutions SuperHires Entrelacé, et ce avec une interface graphique,
  42. primaire, certes, mais ayant le bon gout d'exister.
  43.  
  44.   En fait la raison pour laquelle j'ai programmé ViewerII, c'est qu'aucun des
  45. programmes de ma bibliothèque DP ne me permettait d'afficher correctement
  46. des images SuperHires (enfin à l'époque où j'ai commencé à le
  47. programmer...). Voilà, vous savez tout.
  48.  
  49.   Néanmoins, je tiens à avertir tout de suite les utilisateurs ne disposant
  50. pas du système 3.0 ou supérieur qu'il peuvent d'ores et déjà jeter ce
  51. pogramme loin, très loin, parce qu'il ne risque pas de marcher sur leur
  52. antiquité... :)
  53.  
  54.  
  55.  
  56. II. Utiliser ViewerII.
  57. --------------------
  58.  
  59.   ViewerII peut s'utiliser de trois manières différentes:
  60.         - Soit par le cli.
  61.         - Soit par le workbench via un fichier Project.
  62.         - Soit par le panneau de contrôle.
  63.  
  64.   Dans tous les cas, ViewerII utilise automatiquement la bibliothèque
  65. DataTypes adéquate afin d'afficher l'image sélectionnée.
  66.  
  67. III. Utilisation pour le CLI.
  68. -----------------------------
  69.  
  70.   Si vous lancez ViewerII via le CLI sans préciser de nom de fichier ou de
  71. motif de fichier, celui-ci affichera son superbe :-) panneau de contrôle.
  72. Aucquel cas, reportez-vous au chapître correspondant.
  73.  
  74.   Voici la syntaxe à utiliser :
  75.  
  76.         ViewerII [File] nom_de_fichier [Delay x] Option1 Option2 ...
  77.  
  78.   La place des options, du nom du fichier, etc n'a strictement AUCUNE
  79. importance, de même qu'ils soient en minuscule ou en majuscule n'affecte
  80. en rien le programme.
  81.  
  82.   Voici le détail de leur utilisation:
  83.  
  84. [File] nom_de_fichier :
  85.           La commande [file] précédant le nom du fichier est facultative.
  86.         Elle peut néanmoins être posée dans le cas ou un nom de fichier
  87.         serait identique à l'une des options de ViewerII, ce qui éviterait
  88.         une regrettable méprise.
  89.           En sus des bêtes noms de fichiers, il est également possible de
  90.         donner un motif de fichier AmigaDos. Par exemple PIX:~(#?.info)
  91.         fera afficher tous les fichier du répertoire PIX: à l'exception
  92.         des fichiers .info. Pix:#?.iff fera afficher tous les fichiers
  93.         se terminant par .iff, etc...
  94.  
  95. Delay x :
  96.           L'option DELAY permet de donner un temps maximum d'affichage de
  97.         l'image, en seconde. Par exemple 'Delay 10' affichera une image
  98.         pendant 10 secondes, puis passera à la suite. 'Delay 0', par
  99.         contre, permettra de n'avoir aucun temps d'attente lors de
  100.         l'affichage de l'image.
  101.           Si 'Delay' n'est pas précisé, l'image sera affichée tant que
  102.         l'utilisateur n'aura pas cliqué sur une des boutons de la souris.
  103.           Si 'Delay est précisé, l'utilisateur a néanmoins la possibilité
  104.         de mettre un terme à l'affichage en cliquant sur un des boutons de
  105.         la souris.
  106.  
  107. Quiet :
  108.           Si 'Quiet' apparaît sur la ligne de commande, aucune
  109.         information ne sera donnée sur l'image. Par défaut, ce mode
  110.         n'est pas posé, et des informations sur l'image sont affichées
  111.         dans la fenêtre CLI.
  112.  
  113. LoRes :
  114.           Si 'LoRes' apparaît sur la ligne de commande, l'affichage de
  115.         l'image sera forcé en mode BASSE RESOLUTION.
  116.  
  117. HiRes :
  118.           Si 'HiRes' apparaît sur la ligne de commande, l'affichage de
  119.         l'image sera forcé en mode HAUTE RESOLUTION.
  120.  
  121. SHiRes :
  122.           Si 'SHiRes' aparaît sur la ligne de commande, l'affichage de
  123.         l'image sera forcé en mode SUPER HAUTE RESOLUTION.
  124.  
  125. Lace :
  126.           Si 'Lace' aparaît sur la ligne de commande, l'affichage de
  127.         l'image sera forcé en mode ENTRELACE.
  128.  
  129. NoLace :
  130.           Si 'NoLace' aparaît sur la ligne de commande, l'affichage de
  131.         l'image sera forcé en mode NON-ENTRELACE.
  132.  
  133.  
  134. ATTENTION:
  135.           Lorsque vous utilisez ViewerII du CLI en lui donnant comme
  136.         paramètre un motif (pattern) de fichier, il faut *impérativement*
  137.         mettre la pile de ViewerII à une taille conséquente, ceci parce que
  138.         le DOS est un goinfre pour la pile et que la recherche de fichier
  139.         implique un appel récursif de ses fonctions. Avant de lancer la
  140.         recherche, tapez donc dans votre Shell:
  141.  
  142. > Stack 16000
  143.  
  144.         Qui devrait être suffisant, mais n'hésitez pas à l'augmentez si vous
  145.         rencontrez des problèmes.
  146.  
  147.  
  148.  
  149.  
  150.  
  151. IV. Utilisation via une icone Project.
  152. --------------------------------------
  153.  
  154.   Vous pouvez donner au fichier .info d'une image un outil par défaut.
  155. Rien ne vous empêche de mettre ViewerII. L'image sera alors tout simplement
  156. affichée, et attendra que vous pressiez un des boutons de la souris.
  157.   Vous pouvez de plus donner des options précises sur l'affichage dans les
  158. ToolTypes.
  159.  
  160.   Ceux-ci peuvent être:
  161.  
  162. Delay=x :
  163.           Vous pouvez préciser par ce tooltype la durée d'affichage d'une
  164.         image en secondes. Par exemple Delay=10 affichera l'image pendant
  165.         10 secondes. Delay=0 ne permettra aucun temps d'attente dans la
  166.         visualisation de l'image.
  167.           Si Delay est posé, l'utilisateur a de toute manière la
  168.         possibilité de mettre un terme à l'affichage en pressant bien fort
  169.         un bouton de la souris.
  170.  
  171. LoRes :
  172.           Si cette option est posée dans les tooltypes, l'affichage de
  173.         l'image aura lieu au mode BASSE RESOLUTION.
  174.  
  175. HiRes :
  176.           Si cette option est posée dans les tooltypes, l'affichage de
  177.         l'image aura lieu au mode HAUTE RESOLUTION.
  178.  
  179. SHiRes :
  180.           Si cette option est posée dans les tooltypes, l'affichage de
  181.         l'image aura lieu au mode SUPER HAUTE RESOLUTION.
  182.  
  183. Lace :
  184.           Si cette option est posée dans les tooltypes, l'affichage de
  185.         l'image aura lieu au mode ENTRELACE.
  186.  
  187. NoLace :
  188.           Si cette option est posée dans les tooltypes, l'affichage de
  189.         l'image aura lieu au mode NON-ENTRELACE.
  190.  
  191.  
  192.  
  193.  
  194.  
  195. V. Utilisation via le panneau de contrôle.
  196. ------------------------------------------
  197.  
  198.   Si vous cliquez directement sur l'icône de ViewerII ou si vous l'appelez
  199. sans préciser de nom de fichier, alors le panneau de contrôle apparait.
  200.   Celui-ci est constitué de plusieurs gadgets.
  201.  
  202.   Un gadget de chaîne permet de préciser le nom du fichier à charger.
  203. Pour valider votre entrée, appuyez sur RETURN. Le fichier précisé est
  204. alors chargé s'il existe. Vous pouvez alors appuyer sur le gadget
  205. 'Show Picture' afin de l'afficher.
  206.   Néanmoins, entrer un nom de fichier par un gadget de chaîne peut
  207. souvent s'avérer être ardu. Aussi vous pouvez sans avoir honte cliquer
  208. sur le gadget 'LOAD', qui affichera un sélecteur de fichier ASL vous
  209. permettant de choisir un fichier. Cliquez sur 'OK' pour valider et charger
  210. le fichier.
  211.   Attention néanmoins, suivant le type de fichier et la rapidité
  212. de la machine, il pourra s'écouler un certain temps avant que les détails
  213. sur l'image ainsi que la possibilité d'appuyer sur "Show Picture"
  214. apparaissent. Ainsi, une image JPEG demandera beaucoup plus de temps de
  215. calcul préparatoire qu'un image IFF. Cela dépend néanmoins énormément de
  216. votre librairie DataTypes, aussi je ne saurais trop vous encourager à en
  217. choisir de performantes et adaptées à votre configuration.
  218.  
  219.   Le gadget 'Show Picture' vous permettra d'afficher votre image. Pour
  220. revenir à l'écran du workbench, vous devrez cliquer sur un bouton de
  221. la souris.
  222.  
  223.   Deux autres gadgets vous permettent d'intervenir sur l'affichage d'une
  224. image. Ce sont deux gadgets qui cyclent et vous permettent ainsi de choisir
  225. les paramètres d'affichage.
  226.   Le gadget de gauche vous permet de forcer la résolution en Basse, Haute,
  227. ou SuperHaute. 'Default' vous permet de voir l'image dans sa résolution
  228. normale.
  229.   Le gadge de droite vous permet de forcer ou non l'affichage entrelacé
  230. de l'image. 'Default' permet de voir l'image dans sa résolution normale.
  231.  
  232.   Pour quitter le programme, cliquez simplement le gadget de fermeture de
  233. la fenêtre, en haut à gauche.
  234.  
  235.  
  236.  
  237. VI. BUGS ET LIMITATIONS.
  238. ------------------------
  239. Bugs fixés:
  240.  
  241. Version 1.0 :
  242.           Un truc bête : si la fonte sytème était différente de la
  243.         fonte TOPAZ 8, l'affichage pouvait déborder hors de ses limites.
  244.         Un simple SetFont() suffisait. Comme quoi on est bien peu de
  245.         chose.
  246.           L'affichage d'une image plus grande que l'écran affiché était
  247.         correctement réalisé, mais ne scrollait pas. Il suffisait en
  248.         fait de préciser l'Overscan à l'ouverture de l'écran.
  249.  
  250. Version 1.2 (non distribuée):
  251.           Pas vraiment un bug, mais Viewer s'affichait directement sur
  252.         le BitMap de l'écran. Maintenant Viewer ouvre si possible une
  253.         fenêtre et y affiche l'image. S'il ne peut pas ouvrir la fenêtre
  254.         il l'affiche directement sur le BitMap de l'écran.
  255.           La routine de recherche de fichiers par motif (pattern) ne
  256.         fonctionnait pas correctement et "oubliait" le premier fichier
  257.         trouvé. C'est maintenant réparé. Il saute également correctement
  258.         à partir de cette version les nom de répertoire et les fichiers
  259.         contenant ".info". Ne pas oublier tout de même de mettre une pile
  260.         (stack) conséquente en cas de recherche de motif de fichiers
  261.         (pattern).
  262.  
  263. Version2.0:
  264.           TOUT le code d'affichage et de chargement d'une image a été
  265.         réécrit de manière à utiliser la DataTypes.library (du boulot mine
  266.         de rien!!). L'interface graphique a été laissée telle quelle, car
  267.         elle a été faite sous GadToolsBox v1.4, que j'ai remplacé dans mon
  268.         disque dur par GadToolsBox v2.0, et il se trouve que les fichiers
  269.         des deux versions ne sont pas compatibles entre eux... :(
  270.  
  271. Limitations :
  272.           Pour l'instant ViewerII ne permet pas de visualiser les animations.
  273.  
  274. Ce que je compte rajouter prochainement:
  275.           Une routine de conversion IFF 24 bits -> IFF 256 couleurs
  276.         IFF 24 bits -> IFF HAM8, et IFF xx bits -> IFF yy bits.
  277.  
  278.  
  279. VII. PORTEE DU LOGICIEL.
  280. ------------------------
  281.  
  282.   Comme je crois l'avoir déjà dit, les sources de ce logiciel sont
  283. placées dans le domaine public.
  284.  
  285.   Ce logiciel est placé en FREEWARE, il peut être distribué librement et
  286. sans contrainte, tranquillement placé dans n'importe quelle bibliothèque
  287. de DP à la condition SINE QUA NON  qu'il soit accompagné de ce fichier de
  288. documentation, et de ses fichiers sources complets.
  289.  
  290.   Les fichiers sources peuvent être ré-utilisés sans condition et sans
  291. autorisation de la part de l'auteur (enfin la mienne quoi!).
  292.   Néanmoins j'apprécierais beaucoup d'en avoir connaissance, et de
  293. recevoir un exemplaire du programme dans lequel il a été utilisé.
  294.   Voilà.
  295.  
  296.   Ah! oui j'oubliais : L'utilisation de ce logiciel se fait sous la
  297. responsabilité de l'utilisateur, aucun dommage logiciel causé par ce
  298. programme ne saurait être imputé à l'auteur etc...
  299.  
  300.  
  301.  
  302.   Si vous avez des demandes, informations, conseils, interrogations, reports
  303. de bugs, etc..., vous pouvez me contacter aux adresses suivantes :
  304.  
  305.  
  306.                                ''''
  307.                               (O o)
  308. -------------------------ooOo--(_)--oOoo---------------------------------
  309.  
  310.  
  311.         Rodrigo REYES
  312.         20 Résidence de la grande prairie.
  313.         91330 Yerres
  314.         France.
  315.  
  316. ou bien:
  317.  
  318.         Vous pouvez me laisser une message sur le BBS Electron
  319.         (Brunoy, Paris, FRANCE) sur les deux nodes:
  320.             #1 (+33) 1-69.39.46.30
  321.             #2 (+33) 1-69.39.31.52
  322.         en région parisienne.
  323.  
  324.         Adresses électroniques :
  325.             FidoNet    2:320/214.7
  326.             SparkNet   74:320/100.7
  327.  
  328.             Adresse Internet en cours. 
  329.             prochainement disponible sur vos écrans.
  330.  
  331.         Et (beaucoup) moins régulièrement, dans ma bal sur
  332.         3614 Amigatel, bal Risitop.
  333.  
  334. /*FIN DE FICHIER*/
  335.